Vvmatrix object (Multivariate Analysis Toolbox for Matlab®)

This object represents a data matrix that describes pairwise relationships between variables. This objects inherits from the parent object datamatrix.

Navigate to:     General Description     Class Structure     Class Construction     Class Functions

Each field can be accessed by the dot (.) operation, or by the GET function. The GET function can work on multiple instances simultaneously. Most fields, except for those that are Dependent, can be modified using the dot (.) operation, or by the SET function.

		Field	Description	Type	Default	Dedicated Get/Set Function
		type	Type of matrix. It is always 'variable-variable'	string	'variable-variable'
		row_units	units of the row-variables.	cell	{}
		row_level	level of the row-variables. Can be nominal/ordinal/numerical/unknown	cell	{}
		col_units	units of the column-variables.	cell	{}
		col_level	level of the column-variables. Can be nominal/ordinal/numerical/unknown	cell	{}
		is_square	true if the row-variables are identical to the column-variable.	logical	false
		name	Inherited from datamatrix. name of object, should be short and used as identifier. This field will never be empty.	string	'unnamed'
		description	Inherited from datamatrix. verbal description of the class content.	string	''
		source	Inherited from datamatrix. verbal description of the source of information.	string	''
		row_name	Inherited from datamatrix. Name of the row-category (for example, in gene arrays it can be "tissue").	string	''
		row_sampleset	Inherited from datamatrix. A sampleset describing the row-samples.	sampleset	[]
		row_groupings	Inherited from datamatrix. grouping objects associated with the row-samples.	grouping array	[]
		col_name	Inherited from datamatrix. Name of the column-category (for example, in gene arrays it can be "genes").	string	''
		col_sampleset	Inherited from datamatrix. A sampleset describing the column-samples.	sampleset	[]
		col_groupings	Inherited from datamatrix. grouping objects associated with the column-samples.	grouping array	[]
		matrix	Inherited from datamatrix. the data matrix.	double	[]
		transformations	Inherited from datamatrix. keeping track on transformations that had been applied previously on the matrix.	structure	[]
	Dependent	no_rows	Inherited from datamatrix. number of row-samples.	integer scalar	0	norows
	Dependent	no_cols	Inherited from datamatrix. number of column-samples.	integer scalar	0	nocols

Empty instance (scalar)

an empty vvmatrix instance, with all fields initialized to their default values.

syntax: vvm = vvmatrix;

Empty instance (matrix)

an array of empty vvmatrix instances.

syntax: vvm = vvmatrix(size,'size');

Copy constructor

one vvmatrix instance is copied into another.

syntax: vvm_destination = vvmatrix(vvm_origin);

Construction by field names

an instance is formed by directly providing field values. Any field which is not dependent is permitted.

syntax: vvm = vvmatrix(field_name, field_value, ...);

Reading-in a matrix

A numerical variable-by-variable matrix is read into a vvmatrix instance.

syntax: vvm = vvmatrix(matrix);

Display:

show

displays class content. Source: datamatrix.

I/O functions:

xlswrite

writes VVMATRIX data into an excel sheet.

Information extraction:

colid

finds the IDs of a list of column-variables. Source: datamatrix.

rowid

finds the IDs of a list of row-variables. Source: datamatrix.

SET/GET functions:

colnames

retrieves the column-variable names. Source: datamatrix.

get

get method

matrix

retrieves the variable-by-variable matrix.

nocols

retrieves the number of columns in DATAMATRIX instances. Source: datamatrix.

norows

retrieves the number of rows in DATAMATRIX instances. Source: datamatrix.

rownames

retrieves the row-variable names. Source: datamatrix.

set

set method

Transformations:

deletecols

eliminate col-variables from a VVMATRIX instance.

deleterows

eliminate row-variables from a VVMATRIX instance.

deletevariables

eliminates variables from a square-form VVMATRIX.